PATENT 
5681-64700 
P9138 



"EXPRESS MAIL" MAILING LABEL 

NUMBER EV 318246886 US 

DATE OF DEPOSIT AUGUST 28. 2003 

I HEREBY CERTIFY THAT THIS PAPER OR 
FEE IS BEING DEPOSITED WITH THE 
UNITED STATES POSTAL SERVICE 
"EXPRESS MAIL POST OFFICE TO 
ADDRESSEE" SERVICE UNDER 37 C.F.R. § 
1.10 ON THE DATE INDICATED ABOVE 
AND IS ADDRESSED TO: COMMISSIONER 
FOR PATENTS, P.O. BOX 1450, 
ALEXAND RIA, V A 223 13 J. 

Derrick Brown 



Application Internationalization Using Dynamic Proxies 



Joseph Sheinis 
Michael Baldwin 
Alexander Sherkin 



Atty. Dkt. No.: 5681-64700/P9138 Robert C . Kowert/JDC 

Meyertons, Hood, KJvlin, Kowert & Goetzel, P.C. 

P.O. Box 398 
Austin, Texas 78767-0398 
Phone: (512) 853-8800 



BACKGROUND 

1. Field of the Invention 

5 [0001] This invention relates to computer systems, and more particularly to 
interception of calls to a component of an application in order to provide 
localization/internationalization services for the application component. 

2. Description of the Related Art 

10 

[0002] A major concern for global enterprise applications may be 
internationalization/localization. Enterprises are going global. Even small, family-owned 
companies are finding new customer bases and supply-chain partners in parts of the world 
that they would not previously have considered. The Internet provides the 
15 communications backbone for increasing global interconnectedness. 

[0003] Global operation requires information systems to address a fundamental 
linguistic, cultural, political, financial, and geographic requirements. Users of a global 
application may speak any of dozens of languages. Applications targeted at only a single 

20 country often require multiple language interfaces and units of measure often do not 
correspond exactly to a language. Cultural differences may cause a product or service 
that is highly sought-after in one region to be offensive in another. Some governments 
place limitations on ideas, images, and/or speech. Currencies and forms of payment may 
differ from region to region and governments have various requirements for customs 

25 restrictions, tariffs and taxes. Product pricing, shipping mode, and delivery time may also 
vary by both supply and delivery location. These are just a few of the issues that arise 
when doing business in a global environment. 

[0004] Various obstacles relating to these concerns may be encountered during 
30 implementation of an enterprise application. For example, although application container 
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or server products typically provide common concern-specific logic for use by 
applications, some concern-specific logic may not be supported or may be supported in a 
limited manner. Concern-specific logic for common services such as security may be 
delegated to containers and/or servers in which the application components execute. 

5 

[0005] An example of concern-specific logic, which may not be supplied by 
containers is localization logic. Localization may be the customization of data 
presentation of the set of political, cultural, and region-specific elements represented in an 
application. Each unique representation of the set of such elements may be referred to as 

10 a locale. For example, some of the elements included in such a localization set may be 
language, numerical representation, and units of measure such as date, time, temperature, 
currency, etc. An application that is not internationalized may have all information stored 
in one locale, which may be referred to as the system default locale. In order to 
internationalize such an application, localization logic is typically implemented by adding 

15 additional logic for localization into each application component. 

[0006] Modifying deployed application logic to add localization functionality may 
have a large, negative impact on the availability of the application and thus the bottom 
line of the business in which it is employed. Any time application component logic is 

20 altered the opportunity exists for introducing bugs not only into the code for the 
additional functionality, but also into the existing functions that have already undergone 
extensive verification prior to deployment. The internationalized version of the 
application then becomes an entirely new and more complex application that may need to 
be completely re-verified. Several iterations of deployment and testing may be required 

25 before the internationalized application achieves the same level of reliability as its 
predecessor. 
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♦ 



SUMMARY 



[0007] An application that was not internationalized when coded may be 
internationalized through the addition of interception and localization logic and tables 
5 without modification of the original application logic. The interception logic may be 
configured to intercept calls to an application component and invoke localization logic in 
response to an intercepted call to the application component. The interception logic may 
use dynamic proxies to intercept method calls from a client component to an application 
component both before and after the execution of the method. The interception logic may 
10 use Java reflection to determine whether input parameters or return values associated with 
the method call are localizable. The application component logic may operate on data 
stored in a primary database table in which the data is represented in the system default 
locale. The primary database table may be updated, modified, and maintained by the 
application component logic using JDBC. 

15 

[0008] Client components may generate method calls to the application component 
with input parameters represented in a plurality of locales. The localization logic may 
perform its translation functions operating on data stored in a localization table in which 
data is represented in locales corresponding to the locales in which client components 
20 may submit method calls. The localization table may include localization data 
corresponding to each of the client locales. The localization table may be updated, 
modified, and maintained by the localization logic using JDBC. 

[0009] Each call from a client component to an application component may be 
25 intercepted. The call may be intercepted by a proxy for the application component. The 
proxy may determine if localization logic should be invoked in response to the 
intercepted call. If so, localization logic may be invoked. Thus, localization logic may be 
included after each intercepted call is received. Input parameters associated with the 
remote call may be translated from the locale of the call originator to the system default 
30 locale. The intercepted call may then be invoked as if the initial call had not been 

Atty. Dkt. No.: 568 1 -64700/ P9 1 38 3 Meyertons, Hood, Ki vlin, Kowert & Goetzel, P.C. 



intercepted. After the invocation of the application component, additional localization 
logic may be executed to translate return values from the system default locale to the 
locale of the call originator. The results of invoking the initial call (translated return 
parameters) may be returned to the client component. 

5 

[0010] In one embodiment, the interception logic may also include a service locator. 
The service locator may be configured to return the client-side proxy to the client 
component in response to a call from the client component for a remote interface to the 
application component. The container-side proxy may be further configured to forward 
10 the remote calls to the application component. In one embodiment, the client component 
may execute on a Java Virtual Machine and the application component may execute on a 
different Java Virtual Machine than the client component. The component container may 
be an Enterprise JavaBeans component container and the application component may be 
developed as an Enterprise JavaBean. 

15 

[0011] The localization module including the localization logic may have knowledge 
of the system default locale, how to connect to the database using JDBC, the names of the 
primary and localization tables as well as the value object and entity fields along with 
which fields are required. All of this information may be stored in an XML metadata file 
20 descriptor, which may be loaded upon the startup of the server. In one embodiment, the 
concern-specific logic may be registered as a method invocation listener to receive remote 
method invocations for the application component. 
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BRIEF DESCRIPTION OF THE DRAWINGS 



[0012] FIG. 1 illustrates a three-tier architecture of a computer system, suitable for 
implementing various embodiments; 

5 

[0013] FIG. 2 illustrates one embodiment of interception logic configured to intercept 
calls to an application component and invoke concern-specific logic in response to an 
intercepted call; 

10 [0014] FIG. 3 shows a flowchart of one embodiment of a method for intercepting 
calls to an application component and invoking concern-specific logic in response to an 
intercepted call to the application component; 

[0015] FIG. 4 illustrates one embodiment of interception logic including a service 
15 locator, a client-side proxy and a container-side proxy; 

[0016] FIG. 5 is a flowchart of one embodiment of a method for intercepting remote 
calls to an application component and invoking concern-specific logic in response to an 
intercepted remote call to the application component; 

20 

[0017] FIG. 6 illustrates exemplary primary and localization tables, according to one 
embodiment; 

[0018] FIG. 7 illustrates components of an EJB component container involved in 
25 application component localization, according to one embodiment; 

[0019] FIG. 8 is a flowchart of a method for localizing an application component, 
according to one embodiment; 
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[0020] FIG. 9 is a flow chart of a method of internationalizing an application 
component, according to one embodiment; and 

[0021] FIG. 10 illustrates a computer system that may include one embodiment of 
5 interception logic configured to intercept calls to an application component and invoke 
interception and localization logic in response to an intercepted call to the application 
component. 

[0022] While the invention is described herein by way of example for several 
10 embodiments and illustrative drawings, those skilled in the art will recognize that the 
invention is not limited to the embodiments or drawings described. It should be 
understood, that the drawings and detailed description thereto are not intended to limit the 
invention to the particular form disclosed, but on the contrary, the intention is to cover all 
modifications, equivalents and alternatives falling within the spirit and scope of the 
15 present invention as defined by the appended claims. The headings used herein are for 
organizational purposes only and are not meant to be used to limit the scope of the 
description or the claims. As used throughout this application, the word "may" is used in 
a permissive sense (i.e., meaning having the potential to), rather than the mandatory sense 
(i.e., meaning must). Similarly, the words "include", "including", and "includes" mean 
20 including, but not limited to. 
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DETAILED DESCRIPTION OF EMBODIMENTS 



[0023] A major concern for global enterprise applications may be 
internationalization/localization. Localization may be the customization of data 

5 presentation of the set of political, cultural, and region-specific elements represented in an 
application. Each unique representation of the set of such elements may be referred to as 
a locale. For example, some of the elements included in such a localization set may be 
language, numerical representation, and units of measure such as date, time, temperature, 
currency, etc. An application that is not internationalized may have all information stored 

10 in one locale, which may be referred to as the system default locale. In order to 
internationalize such an application, business calls to application components may be 
intercepted. The parameters associated with the intercepted business calls may be 
translated by localization code from the locale of the caller to the system default locale 
without the need to modify the application component. Likewise the values returned by 

15 the application may be translated by localization code from the system default locale to 
the locale of the caller, again without the need to modify the application code. This may 
allow the internationalization of previously deployed applications with a minimum 
verification effort for the application logic. 

20 [0024] Suitable for implementing various embodiments of the disclosed invention, 
FIG. 1 illustrates a three-tier architecture of a computer system. The application logic of 
the computer system may be divided into application components (e.g., applets, servlets, 
server pages, beans, application clients, database objects) according to function and the 
various application components may be installed on different computers depending on 

25 factors such as security and load distribution. Tiers (e.g., client tier 171, middle tier 175, 
backend tier 178) may represent the logical or physical organization of the application 
components, which may operate across one or more different computers. The different 
computers may be based on different platforms and architectures. In one embodiment, 
the application components of the computer system may be based on a three-tier 

30 architecture. In other embodiments, the application components of the computer system 
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may be based on a two-tier or N-tier architecture. Thus, the application components of a 
computer system based on the three-tier architecture of FIG. 1 illustrate only one example 
of a computer system suitable for implementing various embodiments of the disclosed 
invention. 

5 

[0025] Client tier 171 may include a number of different clients 172A through 172N 
(e.g., device, system, user interface) communicating to application components (e.g., 
servlets, server pages, beans) in the middle tier 175 via the Internet and/or an intranet 
173. The middle tier 175 may include a number of different Web servers 174 A through 

10 174N and/or application servers 176A through 176N. In some embodiments, an 
application server 176 may include functionality typically provided by a Web server 174. 
For example, functionality provided by a Web server 174 may be included in an 
application server 176 eliminating the need for the Web server 174. The backend tier 178 
may include a number of different computer systems such as database 179 A through 

15 backend system 179N. 

[0026] Application components may communicate using different types of protocols 
such as Hyper Text Transfer Protocol Secure sockets (HTTPS), Java™ Database 
Connectivity (JDBC), Java Naming and Database Interface (JNDI), and/or Simple Object 

20 Access Protocol (SOAP). The application components within a tier typically 
communicate with remote application components in an adjacent tier. For example, 
multiple users with access to an application component configured to operate in a client 
tier 171 (e.g., application client accessible via a Web browser) may initiate requests (e.g., 
application program call) to each remote application component configured to operate in 

25 a middle tier 175. Each application component in the middle tier 175 may, in turn, 
initiate requests to the backend tier 178 on behalf of the application component in the 
client tier 171. For example, an application component in the middle tier 175 (e.g., bean) 
may receive a remote request from a Web browser operating in the client tier 171 and in 
response access an application component (e.g., database object) operating in the backend 

30 tier 178. The application component in the backend tier 178 may then provide a 
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response to the application component in middle tier 175 which may complete the remote 
request. 

[0027] Some of the application components operating within the middle tier 175 may 
be configured to run within a component container 177 provided with an application 
server 176 A. Some standard services (e.g., security, transaction management, state 
management, multi-threading) may be built into a platform and provided automatically to 
the application components via the container 177 and/or application server 176 A. The 
component container 177, for example, may be configured to provide concern-specific 
logic for some standard services to application components running within the component 
container 177. For example, component containers 177 may provide application 
programming interfaces for some common services that application components use to 
access the services. 

[0028] Some concern-specific logic may not be provided by the component container 
177, but may be provided for by interception logic, as discussed herein. For example, 
internationalization and/or localization of an application may be facilitated by 
interception logic. FIG. 2 illustrates one embodiment of interception logic 101 
configured to intercept calls to an application component 202 and invoke concern-specific 
logic in response to an intercepted call to the application component 202. Additional 
concern-specific logic, such as concern-specific logic not supported as a standard by a 
component container 177, may be provided and accessed through interception logic 101. 
For example, concern-specific logic accessible through interception logic 101 and 
separate from an application component 202 may provide to the application component 
202 one or more services not provided as a standard service of the component container 
177. Logic for localizing an application component is an example of such concern- 
specific logic that may be provided separately from the application component. 

[0029] Interception logic 101 may be configured to intercept each remote call from a 
client component 209 to an application component 202. In response to the intercepted 
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remote call to the application component 202, interception logic 101 may invoke 
localization logic on the container-side. Localization logic may translate input parameters 
associated with the remote call from the client locale to the system default locale. The 
intercepted remote call to the application component 202 may then be made to the 
application component 202. Localization logic may translate return values generated by 
the application component from the system default locale to the client locale. The 
translated results of the remote call invocation may then be returned to the client 
component 209. Note that a local method call may be localized in the same fashion as 
described for a remote call. 

[0030] As described with FIG. 1, calls may be initiated from one or more application 
components (e.g., a client component 209) to one or more remote (or local) application 
components 202. A client component 209 may be any client of a computer system that 
initiates requests to an application component 202 and receives responses to the requests. 
For example, a client component 209 may be a dynamic Web page that relies on a Web 
server that generates Web pages using standard services provided by an application 
server. A client component 209 may include a Web browser (e.g., Internet Explorer or 
Netscape Navigator) that displays Web pages received from a Web and/or application 
server. In one embodiment, the client component 209 may be a dynamic Web page 
component developed with Java Server Pages or ASP.NET™ in a Web server such as 
Apache, Sun Open Net Environment (ONE) Application Server™ or Microsoft Internet 
Information Server (IIS)™, or any session component that is aware of the locale of the 
user. 

[0031] In one embodiment, the application component 202 whose remote calls may 
be intercepted may be a bean such as an Enterprise JavaBeans™ (EJB™) and the bean 
may run within the component container 177. The application component 202 and/or 
localization logic may be developed using various frameworks such as Java™ 2 Platform, 
Enterprise Edition (J2EE™) from Sun Microsystems, Core Services Framework (CSP) 
from Hewlett Packard, Sun™ ONE Framework from Sun Microsystems, .NET 
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Framework from Microsoft or some other framework. An integrated development 
environment (e.g., Microsoft Visual Studio .NET, open source NetBeans, Sun™ ONE 
Studio) may be used to automatically generate some or all of the application component 
202 and/or localization logic. 

[0032] Figure 3 shows a flowchart of one embodiment of a method for intercepting 
calls to an application component and invoking localization logic in response to an 
intercepted call to the application component. Each call from a client component to an 
application component for which interception logic has been provided may be 
intercepted, as indicated in 310. The remote call may be intercepted by a proxy for the 
application component. The proxy may determine if localization logic should be invoked 
in response to the intercepted call. If so, localization logic may be invoked. Thus, 
localization logic may be included after each intercepted remote call is received, as 
indicated in 320. Input parameters associated with the remote call may be translated from 
the locale of the call originator to the system default locale, as shown at 330. The 
intercepted remote call may then be invoked on the application component as if the initial 
remote call had not been intercepted, as indicated in 340. The application component will 
receive input parameters, perform necessary operations, and return values all in the 
system default locale and, therefore, the interception and locale translation is completely 
transparent to the application component. After the invocation of the application 
component, additional localization logic may be executed to translate return values from 
the system default locale to the locale of the call originator, as shown in block 350. At 
360, the results of invoking the initial remote call (translated return parameters) may be 
returned to the client component. 

[0033] Figure 4 illustrates one embodiment of interception logic including a service 
locator 201, a client-side proxy 203 and a container-side proxy 205. The service locator 
201 may be configured to locate a remote interface of the application component 202 for 
use by a client to remotely access the application component. In response to a request 
from a client component 209, the service locator 201 may return a client-side proxy 203 
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that includes a remote interface to access the application component 202. The client-side 
proxy 203 may be configured to receive remote calls made by client component 209 to 
the application component 202. The client-side proxy 203 may forward the remote call to 
container-side proxy 205. Thus, container-side proxy 205 may "intercept" the remote call 
when it receives the remote call from the client-side proxy, in one embodiment. The 
container-side proxy 205 may determine whether or not to invoke localization logic 207 
in response to the remote call. For example, if the call includes input parameters related 
to localizable data such as language, numerical representation, and units of measure such 
as date, time, temperature, currency, etc. then proxy 205 may invoke localization logic 
207. The container-side proxy 205 may forward the remote call to the application 
component 202 for performance of the remote call. Post execution localization may be 
applied to any results, and the translated results may be returned to the client. 

[0034] In one embodiment, to provide a container-independent approach, the service 
locator 201 may be configured separately from the component container 177. The service 
locator 201 may also be implemented as part of the component container 177 in other 
embodiments. 

[0035] In one embodiment, implemented based on a service locator pattern, the 
service locator 201 may be configured to locate the remote interface of the application 
component 202 in response to an initial remote call from the client component 209 to the 
service locator 201. In other embodiments, the service locator may be implemented as 
part of a naming and directory service. The service locator returns a client-side proxy 203 
to the client component 209. In one embodiment, the client-side proxy 203 may be 
configured from a class, instantiated on the client-side and configured to maintain a 
remote reference to the application component 202. The client-side proxy 203 may 
implement a remote interface of the application component 202 and forward remote calls 
to the container-side. 



Atty. Dkt. No.: 5681-64700/ P9138 



12 



Meyertons, Hood, Kivlin, Kowert & Goetzel, P.C. 



[0036] The service locator 201 may be configured to locate the remote interface 
instead of the client component 209 directly locating the remote interface from a directory 
and naming service. By having the client make requests for access to application 
components through the service locator, a client-side proxy may be returned that includes 
a remote interface to the requested application component. Returning a client-side proxy 
instead of just the remote interface allows remote calls to be "intercepted" for localization 
logic. 

[0037] In one embodiment, the client-side proxy 203 may maintain a separate proxy 
object for providing access to business application methods of the application component 
202. For example, the client-side proxy 203 may intercept each instantiation method 
(e.g., a create method) of an application component 202 and create a separate proxy 
object to implement the corresponding business application methods. In one 
embodiment, the client-side proxy 203 may be implemented using the 
java.lang.reflect.Proxy class of the Java Development Kit (JDK) from Sun Microsystems, 
Inc. The client-side proxy 203 may also be configured to do more than forward remote 
calls to the container-side. For example, in one embodiment, the client-side proxy 203 
may be configured to locally cache state information for the application component 202 
to avoid network overhead on each method call. 

[0038] In one embodiment, the interception logic 101 may be configured to create a 
container-side proxy 205. For example, when the client-side proxy 203 intercepts an 
instantiation method (e.g., a create method) of an application component 202, the 
container-side proxy 205 may be instantiated in the component container 177. In one 
embodiment, the container-side proxy 205 may be configured from a class, instantiated 
on the container-side and configured to maintain a container-side remote reference to the 
application component 202. This instance of the container-side proxy 205 may be 
cached, and a reference to the container-side proxy 205 generated and returned to the 
client-side proxy 203. The container-side proxy remote reference to the application 
component 202 may be stored and maintained by the client-side proxy 203. The 
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container-side proxy 205 may be configured to invoke localization logic included on the 
container-side 177. In one embodiment, the container-side proxy 205 may be 
implemented using a single stateless (or stateful) session bean. 

[0039] The client-side proxy 203 may intercept each remote call to the application 
component 202 that originates from the client component 209. In one embodiment, 
requests from client component 209 may be forwarded from client-side proxy 203 to 
container-side proxy 205 using a serializable "method call" object, including information 
on the application component 202 being accessed, request type (e.g. method name) and 
request parameters. In one embodiment, the container-side proxy 205 may be configured 
to determine if localization logic should be invoked. The container-side proxy 205 may 
then invoke the container-side localization logic 207. Thus, instead of configuring each 
application component 202 of a computer system to include the localization logic 207, the 
localization logic 207 may be implemented as separate common concern logic and 
invoked in response to intercepted remote calls. Client-side and/or container-side proxies 
may be established for a plurality of client and application components to provide access 
to the common client-side or container-side localization logic without having to include 
the localization logic in each client or application component. In some embodiments, the 
client or application components may not even be aware of the proxies and/or localization 
logic. The application component may be designed for only a single locale, e.g. the 
system default locale. By the inclusion of interception and localization logic separate 
from the logic of the application component, the application component may be 
transparently internationalized to support different locales and/or regions without 
modifying the application component logic. 

[0040] After invoking localization logic 207, the container-side proxy 205 may 
invoke the remote call to the application component 202. Localization logic 207 may 
receive values returned by the application component in response to the call and translate 
these values from the system default locale to the locale of the client requestor. The 
localized results may be forwarded to the client component 209. Appropriate exceptions 
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may be generated that may prevent the remote call from being invoked. In one 
embodiment, the result of the call to application component 202 may be forwarded from 
container-side proxy 205 to client-side proxy 203 using a serializable "method result" 
object, including information on the method result and exception thrown, if any. 

[0041] In one embodiment, localization logic component 207 may be registered in an 
application server as a method invocation listener. For example, when a method 
invocation is received by container-side proxy 205 for application component 202, prior 
to forwarding the method invocation to the application component, it may be sent to 
localization logic component 207. Thus, localization logic may be provided for multiple 
application components without the client or application server container being aware of 
the interception logic (e.g. proxy framework) and localization logic. 

[0042] Figure 5 shows a flowchart of one embodiment of a method for intercepting 
remote calls to an application component and invoking localization logic in response to 
an intercepted remote call to the application component. The localization logic may be 
configured to provide a service that is not included as a standard service of a component 
container. The localization logic and the application component may be configured to 
run within a component container. The following method is exemplary. Other variations 
may be performed by various embodiments of methods for intercepting remote calls to an 
application component and invoking localization logic in response to an intercepted 
remote call to the application component. 

[0043] In one embodiment, a service locator may receive a call from a client 
component to access a remote application component, as indicated in 500. In one 
embodiment, instead of a client component directly locating a remote interface to the 
application component, the client calls the service locator to locate the remote interface. 
For example, in response to a remote call from a client component for access to the 
application component, the service locator may locate a remote interface of the 
application component. A client-side proxy that implements the application component 
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remote home interface may then be instantiated and returned to the client component, as 
indicated in 510. The client-side proxy may appear to the client as the actual remote 
home interface. Thus, subsequent remote calls to the application component may then be 
received by the client-side proxy. 

[0044] In one embodiment, a container-side proxy may be created. For example, 
when the client-side proxy intercepts an instantiation method (e.g., a create method) of an 
application component, the container-side proxy may be instantiated by the component 
container, as indicated in 520. The container-side remote reference to the application 
component may be stored and maintained by the container-side proxy. Localization logic 
included on the container-side may be invoked from the container-side proxy. 

[0045] Each call to the application component, which originates from the client 
component may be received by the client-side proxy, as indicated in 530. The intercepted 
remote call may then be forwarded to the container-side proxy, as indicated in 540. In 
one embodiment, the container-side proxy may determine if localization logic has been 
included on the container-side and should be invoked or the container-side localization 
logic may be a listener for remote calls received at the container-side proxy, as indicated 
in 550. The container-side localization logic may then be invoked on the container-side, 
as indicated in 560. Thus, localization logic may be invoked on the container-side when 
each remote call is received by the container-side proxy. At decision block 575, the call 
may be examined to determine whether localization is required prior to the execution of 
the application component method. For example, the call may include input parameters 
that need to be translated into the system default locale before processing. If necessary, 
pre-execution localization logic may be invoked as shown at 580. 

[0046] After invoking localization logic on the container-side, the remote call may be 
invoked as if the original remote call was not intercepted, as indicated in 570. At 
decision block 585 the results of the execution of the method call may be examined to 
determine whether post-execution localization is required. For example, execution of the 
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method call may result in the generation of one or more return values, which are 
localizable. If required, post-execution localization may be performed, as shown at block 
590. Results of the method invocation in the appropriate locale may then be forwarded to 
the client component, as indicated in block 595. Appropriate exceptions may be 
generated that may prevent the original remote call from being invoked. In one 
embodiment, exceptions may be propagated normally through the proxies such that the 
client-side proxy receives a remote exception wrapping the actual exception. In another 
embodiment, the exception may be captured by the container-side proxy and returned as a 
part of the results to the client component. The client-side proxy may then "re-throw" the 
actual exception to the client. In this embodiment, other information may also be 
returned in the results with the exception. For example, a container-side proxy reference 
for a call that resulted in an exception may be returned with the exception to the client. 

[0047] As stated previously, an application that is not internationalized may have all 
information represented in one locale, which may be referred to as the system default 
locale. In order to internationalize the application, the service locator module returns 
dynamic proxies to intercept remote and local business calls. Each component in the 
application may have a corresponding database table where the system default locale 
information may be stored and which may be referred to as the primary table. Each 
localizable (translatable) entity may additionally be associated with one or more 
localization tables in which each locale translation, applicable to the given entity, may 
reside. 

[0048] The presence of the elements needed for internationalization may not impact 
any primary table thus minimizing the impact of internationalization on existing 
applications. Since internationalization may only require the addition of new 
(localization) tables without modifications to existing tables, the main logic of an 
application may be virtually unaffected. Localization table entries may include the 
following information: a locale ID specifying the locale to which a particular entry 
corresponds, an object ID which may be used as the foreign key to the corresponding 
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primary table and may show the primary key of an entity to which this translation should 
be applied, and all entity bean localizable fields. The primary key for this table may 
include the locale ID and object ID fields. 

[0049] FIG. 6 illustrates exemplary primary and localization tables, according to one 
embodiment. An application component called Organization may be mapped to a 
primary table called ^organization 600. All information in the primary table 
t_organization 600 may be stored in the system default locale. Application component 
Organization and the corresponding session component may process information only in 
the system default locale. These aspects of the environment may be the same as if the 
application were not internationalized. 

[0050] The localizable entity Organization may be associated with primary table 
t_organization 600. Primary table ^organization 600 may include two localizable fields: 
title 610 and description 615. The internationalization of Organization may include the 
addition of localization table t_organizationJocale 650, which includes the sets of 
translations corresponding to each instance of organization. The system default localejd 
may be enJJS. Note that an organization with an object id 615 of org2 has empty fields 
for title and description since the entry may not be in the default locale. Also note that 
some information may be duplicated in the two tables. 

[0051] The primary key of ^organization 600 may be objectjd while the primary 
key of t_organization_locale 650 may be composed of objectjd 655 and localejd 660. 
Objectjd 655 from t_organization_locale 650 may be a foreign key into objected 605 of 
t_organization 600. Note that the primary table of Organization may be unaffected by 
this method of internationalization. 

[0052] Other embodiments of methods for internationalization of applications may 
require the alteration of primary tables. In one embodiment, title 610 and description 615 
may be removed from primary table 600. In another embodiment, an additional column 
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referred to as locale_id may be included in primary table 600. In this case locale Jd may 
indicate whether a given row in the primary table is in the default locale. If a row is in 
the default locale, there may be no need to use the localization table as it is clear that the 
information included in this entry is valid. For the primary table t_organization 600, the 
localejd column would indicate that the orgl entry is in the default locale, while the org2 
entry is not. Therefore, obtaining the organization "orgl" would only require accessing 
the primary table 600, while obtaining the organization "org2" would require accessing 
the localization table 650. 

[0053] The EJB Proxy Module may include a proxy listener (the class implementing 
java.lang.reflect.InvocationHandler) associated with each proxy returned by the service 
locator. The InvocationHandler's invoke(...) may be called on any entity bean business 
method invocation. The proxy listener may include two sets of registered listeners, which 
may be referred to as pre-invocation listeners and post-invocation listeners. When the 
invoke(...) method is called on the proxy listener, each registered pre-invocation listener 
may be notified and may take some action, the actual called entity bean method may be 
executed, and each registered post-invocation listener may be notified and take some 
action. 

[0054] In the embodiment illustrated in FIG. 7, the proxy listener 705 may include 
PrelnvocationListener 760 and PostlnvocationListener 770 and may act as a translation 
interface between a locale-aware client (e.g. a session bean including localized 
information) and locale-independent entity beans such as application component 755 and 
EJB component container 750. The proxy listener 705 may register the two listeners 
referred to as PrelnvocationListener 760 and PostlnvocationListener 770 with the EJB 
Proxy Module. When any method is called on the entity bean's remote or local interface, 
PrelnvocationListener 760 may be notified before the execution of the method, while 
PostlnvocationListener 770 may be notified after the execution of the method. 
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[0055] Upon notification of a method call, localization logic 715 may determine the 
locale of the caller. If the locale of the caller is the system default locale, localization 
logic 715 may invoke application component 755. Application component 755 may 
perform its function using information from and updating the primary table 765, and 
return results to the caller. If the locale of the caller is other than the system default 
locale, localization logic may translate input parameters associated with the method call 
from the locale of the caller to the system default locale using information included in the 
appropriate localization table 775. In response to method calls requiring the update or 
modification of the data table, localization logic 715 may maintain localization tables 775 
while the application component 755 may perform necessary modifications to the primary 
table. For method calls not in the system default locale, localization logic 715 may 
intercept return values produced by the invocation of the application component and 
translate them from the system default locale to the locale of the caller and then return the 
translated values to the calling entity. 

[0056] As shown in the flowchart of FIG. 8, if either PrelnvocationListener or 
PostlnvocationListener are notified, they may check to determine whether the called 
method is related to localization as shown at block 800. If the method requires or returns 
localizable parameters, the dynamic proxies may invoke the appropriate localization logic 
to perform the required translations as indicated in 810. For example, if the native locale 
for the application is United States and a client in Germany is attempting to get a price for 
an item, the PrelnvocationListener proxy may initiate localization logic to convert the 
item description from German to English. This parameter translation may be 
accomplished by means of Java Reflection in some instances. 

[0057] The application component Bean may use the translated descriptive 
information to retrieve the price of the item in dollars. The PostlnvocationListener may 
recognize that a conversion of the output parameter is required and initiate further 
localization logic to translate the price of the item from dollars to euros before returning 
the value to the client. As illustrated in block 820, the localization logic may maintain the 
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localization table while the primary table may be maintained through the initial entity 
bean. 

[0058] For example, an entity EJB named Organization may be provided in several 
locales. Organization may include several methods as follows. The method public 
OrganizationValueObject getValueObjectf) may be intercepted by the 
PostlnvocationListener. The entity bean may return information in the system default 
locale. If the current session requires the information to be in a different locale, 
localization logic may translate the return value using data from the localization table and 
applying JDBC and/or Java Reflection. 

[0059] The method The method public void update( OrganizationValueObject obj) 
may be intercepted by the PrelnvocationListener. If obj is not in the system default 
locale, localization logic may insure that localizable fields in the primary table are not 
updated by modifying obj. The localization logic may also update the localization table 
using JDBC. 

[0060] The method The method public void create(ComputerDescriptionValueObject 
obj) may be intercepted by the PrelnvocationListener. If obj is not in the system default 
locale, localizable fields may be set to null through Java Reflection since the primary 
table never stores information, which is not in the system default locale. The localization 
logic may use the input parameters to create a record in the localization table using 
JDBC. 

[0061] The method public void remove may be intercepted by the 
PostlnvocationListener. The localization logic may remove all information referring to 
the entity from the localization table. 

[0062] The localization module including the localization logic may have knowledge 
of the system default locale, how to connect to the database using JDBC, the names of the 
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' primary and localization tables as well as the value object and entity fields along with 
which fields are required. All of this information may be stored in an XML metadata file 
descriptor, which may be loaded upon the startup of the server. 

[0063] FIG. 9 is a flow chart of a method of internationalizing an application 
component, according to one embodiment. For a non-internationalized application that 
has been widely deployed, a method of internationalization that impacts the application 
component logic either not at all, or to the least extent possible may be desirable. As 
shown at 900, localization logic may be created that provides for the conversion and/or 
translation of localizable parameters completely independently of the application 
component logic. Block 910 indicates that localization tables may be created to store 
values of all localizable parameters and return values for each needed locale. For 
example, an application whose system default locale is United States, English may need 
to be deployed in Switzerland. Switzerland may have four national languages and it may 
be desirable to support at least German and French localizations. German and French 
localization tables may be created to store localized forms of messages, units of measure, 
and other information used by the application. 

[0064] As indicated at block 920, dynamic proxies may be instantiated for each 
method associated with the application component that may include parameters requiring 
localization. A dynamic proxy may include a pre-invocation listener that is notified of 
the application component method call before the method is executed. The pre- 
invocation listener may determine whether any of the input parameters associated with 
the method need to be localized, and if so, may invoke localization logic to perform the 
needed translation. The dynamic proxy may also include a post-invocation listener proxy, 
which may be instantiated to be notified upon the completion of execution of the 
application component. The post-invocation listener may determine whether any of the 
return values associated with the method need to be localized, and if so, may invoke 
localization logic to perform the needed translation. The service locator may need to be 
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modified so that it returns that address of the proxy corresponding to the application 
component, as indicated at block 930. 

[0065] FIG. 10 illustrates one embodiment of a computer system 1100 that may 
include interception and localization logic 1105. Computer system 1100 may include 
many different components such as memory 1110, a central processing unit (CPU) or 
processor 1120, and an input/output (I/O) interface 1125. Interconnect 1115 is relied 
upon to communicate data from one component to another. For example, interconnect 
1115 may be a point-to-point interconnect, a shared bus, a combination of point-to-point 
interconnects and one or more buses, and/or a bus hierarchy including a system bus, CPU 
bus, memory bus and I/O buses such as a peripheral component interconnect (PCI) bus. 

[0066] The computer system 1 100 preferably includes a memory medium on which 
computer programs according to various embodiments may be stored. The term "memory 
medium may include an installation medium, e.g., a CD-ROM, or floppy disk; a 
computer system memory such as DRAM, SRAM, EDO DRAM, SDRAM, DDR 
SDRAM, Rambus RAM, etc., or a non-volatile memory such as a magnetic media, e.g., a 
hard drive 1130, or optical storage. The memory medium may include other types of 
memory as well, or combinations thereof. In addition, the memory medium may be 
located in a first computer in which the programs are executed, or may be located in a 
second different computer, which connects to the first computer over a network. In the 
latter instance, the second computer provides the program instructions to the first 
computer for execution. 

[0067] Also, the computer system 1100 may take various forms, including a personal 
computer system, mainframe computer system, workstation, network appliance, Internet 
appliance, personal digital assistant (PDA), television system or other device. In general, 
the term "computer system" can be broadly defined to encompass any device having a 
processor, which executes instructions from a memory medium. The memory medium 
preferably stores a software program or programs for event-triggered transaction processing 
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as described herein. The software program(s) may be implemented in any of various ways, 
including procedure-based techniques, component-based techniques, and/or object-oriented 
techniques, among others. For example, the software program may be implemented using 
ActiveX controls, C++ objects, JavaBeans, Microsoft Foundation Classes (MFC), or other 
technologies or methodologies, as desired. 

[0068] Memory 1110 may store program instructions accessed by the CPU 1 120. For 
example, one or more applications 1150, interception and localization logic 1105 as 
described herein, and an operating system 1 155 may be stored in memory 1110. 

[0069] Computer system 1100 may further include other software and hardware 
components, such as an input/output (I/O) interface 1125, that may be coupled to various 
other components and memory 1110. The CPU 1120 may acquire instructions and/or data 
through the I/O interface 1125. Through the I/O interface 1125, the CPU 1120 may also 
be coupled to one or more I/O components. As illustrated, VO components may include a 
hard disk drive 1130, a network adapter 1135, a display adapter 1140 and/or a removable 
storage adapter 1145. Some components 1130 to 1145 may be coupled to the I/O 
interface 1125. In addition, the computer system 1100 may include one or more of a 
particular type of component. The computer system 1100 may include one or more 
components coupled to the system through a component other than the I/O interface 1 125. 
Some computer systems may include additional and/or other components such as 
application software (e.g., stored in memory 1110), other CPUs, video monitors or other 
displays, track balls, mice, keyboards, printers, plotters, scanners, or other types of I/O 
devices for use with computer system 1100. 

[0070] In one embodiment, interception and localization logic 1105 may be 
configured within an application server. The application server may provide system-level 
services to application components that operate across different computers based on 
different platforms and architectures. According to one embodiment, the application 
components may be implemented on virtual machines (VMs) (e.g., Java Virtual 
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Machines) coupled to interception and localization logic 1105. In one embodiment, the 
client-side application components may be implemented on virtual machines (VMs) (e.g., 
Java Virtual Machines). The virtual machines may be implemented on one or more 
computers 1100. Interception and localization logic 1105 may operate on different and 
various types of computers that may communicate to each other over a network. For 
example, a client may operate on a desktop computer running Windows™ NT from 
Microsoft and an application server, in one embodiment, may operate on a minicomputer 
running an operating system such as Sun™ Linux from Sun Microsystems. 

[0071] The flow charts described herein represent exemplary embodiments of 
methods. The methods may be implemented in software, hardware, or a combination 
thereof. The order of method may be changed, and various elements may be added, 
reordered, combined, omitted, modified, etc. 

[0072] Various modifications and changes may be made to the invention as would be 
obvious to a person skilled in the art having the benefit of this disclosure. It is intended 
that the following claims be interpreted to embrace all such modifications and changes 
and, accordingly, the specifications and drawings are to be regarded in an illustrative 
rather than a restrictive sense. 

[0073] Various embodiments may further include receiving, sending or storing 
instructions and/or data implemented in accordance with the foregoing description upon a 
computer readable medium. Generally speaking, a computer readable medium may 
include storage media or memory media such as magnetic or optical media, e.g., disk or 
CD-ROM, volatile or non-volatile media such as RAM (e.g. SDRAM, DDR SDRAM, 
RDRAM, SRAM, etc.), ROM, etc. as well as transmission media or signals such as 
electrical, electromagnetic, or digital signals, conveyed via a communication medium 
such as network and/or a wireless link. 
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